Instructions for running Jabp from a USB flash drive
----------------------------------------------------

Jabp is a small Java program, currently <250K in size.  This means that it is highly portable and doesn't require a multi-megabyte install process.  It is completely self-contained and doesn't rely on any other software except a Java runtime.  It doesn't have any dependencies, which is good news for Linux owners - it will run on virtually any Java-enabled Linux computer.

You can run Jabp directly from a USB flash drive on any Java-enabled desktop, notebook or netbook.  You can store your the Jabp program and your Jabp data files directly on the USB drive.  This is convenient if you use multiple machines and don't want to leave your files scattered around.

*Warning*: if you run Jabp only from a USB drive then:

a) Make sure you take regular back-ups in case you lose the USB drive
b) Consider password-protecting your data

Here are the steps.  Firstly, copy the file Jabp.jar to your USB flash drive.  Now follow the instructions either to set up new Jabp data files, or to transfer existing Jabp data files.

1. Set up new Jabp data files
-----------------------------
_rasekhoon.net

Insert your USB drive into your computer.

On Windows machines, open in Windows Explorer.  Double-click on Jabp.jar to launch the program.

On a Mac or Linux computer, open a terminal window and change the directory to the USB drive (on a Mac, this will likely be a sub-folder of /Volumes/ ).  You can change the directory using the cd command.  Type 'java -jar Jabp.jar' to launch the program.

As you are going through the new file set-up process in Jabp, make sure that you set the location to be your USB drive, and specify a suitable filename.  Complete the set-up process by specifying your home currency and you can now start using Jabp.

2. Moving existing Jabp data files to a USB drive
-------------------------------------------------

Locate your existing Jabp data files on your computer's hard drive.  Copy all the files ending with '.jabp' to your USB drive.  Copy Jabp.ini to your USB drive.  Follow the instructions in (1) to run the Jabp program.  The program will open the last-used data files from your hard disk.  Use the File>Open option to open the files from your USB drive.  Continue using Jabp as normal.

3. Using Jabp from the USB drive
--------------------------------

You can now run Jabp from your USB drive by inserting into your computer and launching Jabp as described above.  This will always work correctly unless you move to a different computer where the USB drive is mounted with a different identifier.  In that case, you will get a message saying that your data files don't exist.  This is because Jabp is looking in the wrong place.  Simply click on Open File and navigate to the USB drive as shown on the new computer.  Select any one of your Jabp data files and continue as normal.

4. Advanced users
-----------------

If you know how to create a Windows batch file or a Linux shell (eg. bash) then you can create a script which will launch Jabp from a USB drive on your computer.  That's beyond the scope of this simple readme file.


Malcolm Bryant
November 2008
Last updated 11 November 2008
